home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / prfl107b.zip / PROFILER.DOC < prev    next >
Text File  |  1992-04-17  |  8KB  |  213 lines
  1.                                  PROFILER v.1.00
  2.                                        for
  3.  
  4.                           all versions of RemoteAccess,
  5.  
  6.                             all versions of QuickBBS,
  7.  
  8.                                        and
  9.  
  10.                       all Bulletin Board Programs which use
  11.                      DORINFO1.DEF files that are compatible
  12.                            with those mentioned above!
  13.  
  14.  
  15.                           Written By Armando Caceres
  16.  
  17.  
  18.  
  19.                     Copyright (C) 1992 by Armando Caceres.
  20.                               All Rights Reserved.
  21.  
  22.  
  23.                                 1:3812/30 FIDONet
  24.  
  25.                              *** April 17, 1992 ***
  26.  
  27.  
  28.  
  29.      What is PROFILER?
  30.      ─────────────────
  31.  
  32.      PROFILER is a database door that can be run as a shell from a BBS
  33.      program.  It allows the caller to enter information about
  34.      themselves (their profile) and to read other callers profiles (this
  35.      can get to be a lot of fun!).  Currently, it only supports those
  36.      users who have ANSI turned on and has been tested with RA and QBBS.
  37.      It should work with any BBS that can generate a Dorinfo1.DEF drop
  38.      file.
  39.  
  40.      Copyright Notice
  41.      ────────────────
  42.  
  43.      The PROFILER Door package is Copyright (C) 1992 by Armando Caceres.
  44.      You may not distribute modified or otherwise reverse-engineered
  45.      portions of the Profiler package without the written permission of
  46.      Armando Caceres, the author.
  47.  
  48.      You are encouraged to distribute PROFILER in archived form, but you
  49.      must include all original files in the archive.
  50.  
  51.  
  52.      Registering PROFILER
  53.      ────────────────────
  54.  
  55.      PROFILER is not free software, it is ShareWare.   You are allowed
  56.      to use PROFILER for a reasonable trial period (not to exceed 30
  57.      days).  If, after this trial period, you continue to use PROFILER,
  58.      you are expected to register with the author.
  59.  
  60.      PROFILER is fully functional (and always will be).  It is not
  61.      crippled in any way.  The only advantage to registering PROFILER is
  62.      that you will be legal, and will encouraging me to write more
  63.      doors.  You will also receive an extra set of SySop utilities
  64.      (ProUtil) that will let you perform maintenance on the PROFILER
  65.      data files and index.  With PROUtil you will be able to delete user
  66.      profiles, pack the database (recover space taken by by deleted
  67.      records), and re-build the index if for some reason your original
  68.      gets damaged.
  69.  
  70.      PROUtil IS NOT shareware.  It is not a try before you buy program.
  71.      Only those who register PROFILER will receive a copy of this extra
  72.      utility.  The registration form is enclosed in REGISTER.FRM.
  73.  
  74.      Registering entitles you to use all past, present, and future versions
  75.      of PROFILER and PROUtil for as long as you desire.
  76.  
  77.  
  78.      Disclaimer
  79.      ──────────
  80.  
  81.      The PROFILER package is provided as is, without warranty of any
  82.      kind, either expressed or implied.
  83.  
  84.      In no event shall I, Armando Caceres, be liable to you or anyone
  85.      else for any damages, including any lost profits, lost savings or
  86.      other incidental or consequential damages arising out of the use or
  87.      inability to use this program.
  88.  
  89.  
  90.      Reporting Problems
  91.      ──────────────────
  92.  
  93.      Problems encountered in running PROFILER should be reported to the
  94.      author immediately via FidoNet, or via normal 'snail' mail.  Please
  95.      include any error information which may have been reported on the
  96.      screen.
  97.  
  98.      Most errors are the result of incorrect installation of the program.
  99.      Check the configuration file(s) and reread the documentation thoroughly.
  100.      The most common errors are typos made while configuring the door, as
  101.      well as the batch files.
  102.  
  103.  
  104.      Product Support
  105.      ───────────────
  106.  
  107.      Support for PROFILER is available via FidoNet Netmail to 1:3812/30,
  108.      via the RA_UTIL or DOORWARE echos, via my BBS, or via normal mail
  109.  
  110.  
  111.      Installation
  112.      ────────────
  113.  
  114.      The PROFILER Door is very easy to setup.  PROFILER must be called
  115.      from the subdirectory where it resides and the path to the
  116.      DORINFO1.DEF passed as a parameter.
  117.  
  118.      A simple batch file can be used to
  119.      run it from the BBS program itself.
  120.  
  121.          Menu Type:  7
  122.      Optional Data:  c:\command.com /c Profiler.bat
  123.  
  124.      Profiler.bat should change to the directory where profiler resides.
  125.      For example, if Profiler.exe is in its own directory called
  126.      C:\DOORS\PROFILER and the drop file(dorinfo1.def) is in your BBS
  127.      directory C:\BBS\ then your batch file might look like:
  128.  
  129.      @echo off
  130.      cls
  131.      c:
  132.      cd\doors\profiler   {switch to profiler subdirectory}
  133.      profiler C:\BBS\    {execute profiler and pass the path of Dorinfo1.def}
  134.      cd\bbs              {switch back to BBS directory when profiler terminates}
  135.      exit                {exit the batch file}
  136.  
  137.  
  138.      PROFILER also supports multinode BBS's running share.  If share is
  139.      detected it will do record locking.  If you are running multinode
  140.      just pass the path to your DORINFO1.DEF file to each node (you
  141.      should never pass the same path to more than one node.  Folowwing
  142.      is an example I use for running it on my three node BBS...
  143.  
  144.          Menu Type:  7
  145.      Optional Data:  *C /c \RA\Profiler.bat *N *M
  146.  
  147.  
  148.      PROFILER.BAT
  149.  
  150.      @Echo Off
  151.      CD\RA\DOORS\PROFILER
  152.      Cls
  153.      if %1 == 1 goto Profile1
  154.      if %1 == 2 goto Profile2
  155.      if %1 == 3 goto Profile3
  156.      Exit
  157.  
  158.      :Profile1
  159.      Profiler C:\RA\NODE1\
  160.      CD\RA\NODE1
  161.      Exit
  162.  
  163.      :Profile2
  164.      Profiler C:\RA\NODE2\
  165.      CD\RA\NODE2
  166.      Exit
  167.  
  168.      :Profile3
  169.      Profiler C:\RA\NODE3\
  170.      CD\RA\NODE3
  171.      Exit
  172.  
  173.  
  174.  
  175.  
  176.      Path to DORINFOx.DEF
  177.      ────────────────────
  178.  
  179.      This  is the  full path  to the DORINFOx.DEF file made by your BBS.
  180.      If your BBS doesn't make this data file, then you must use a door
  181.      converter.  Profiler does not use an EXITINFO.BBS file.  The path
  182.      to DORINFOx.DEF must have a backslash, "\", at the end.
  183.  
  184.  
  185.  
  186.      Closing
  187.      ───────
  188.  
  189.      I hope you enjoy Profiler.  I spent about 6 weeks writing a door
  190.      which should not have taken more than a few days.  Actually, the
  191.      first version I finished in about 4 evenings.  That version used
  192.      fixed length records and was very inefficient in its use of memory
  193.      and hard disk space.  I decided that if I was going to allow other
  194.      people to use this program I needed to do a little better.  I
  195.      changed to entire structure of the data files and went to variable
  196.      length records and incorportated the use of pointers so Profiler
  197.      would only use as much memory as it actually needed (it will not go
  198.      grab a big chunk of memory every time it runs.  If you only have on
  199.      record in the Profiler database then it will only use about 45
  200.      bytes.  If you have 100 records then it will use 4500 bytes (there
  201.      are 1024 bytes in one K!).  Also, the datafiles stored on disk
  202.      (Profiler.DAT) is completely packed.  It uses disk space very
  203.      efficiently.  TO get the most efficient use, pack the database
  204.      every once in a while.  You will need ProUtil to do this which
  205.      means you need to register Profiler to get it.
  206.  
  207.  
  208.      If I get enough support my next program will be a database manager
  209.      that will allow SySops to build their own databases which will work
  210.      in the BBS environment without any problem (watch out DBase and
  211.      Paradox).
  212.  
  213.